<!DOCTYPE HTML>
<html lang="en">
<head>
  <meta name="copyright" content=
  "Copyright (c) IBM Corporation and others 2000, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page.">
  <meta charset="utf-8">
  <script src="PLUGINS_ROOT/org.eclipse.help/livehelp.js"></script>
  <link rel="STYLESHEET" href="../book.css" type="text/css">
  <title>Ant Runtime</title>
</head>
<body>
  <h1>Ant Runtime</h1>
  <p>The following preferences can be changed on the <a class="command-link" href=
  'javascript:executeCommand("org.eclipse.ui.window.preferences(preferencePageId=org.eclipse.ant.ui.AntRuntimePreferencePage)")'>
  <img src="PLUGINS_ROOT/org.eclipse.help/command_link.svg" alt="command link"> <strong>Ant &gt; Runtime</strong></a>
  preference page.</p>
  <h2>Classpath Options</h2>
  <p>On the Classpath tab you can add additional classes defining tasks and types to the Ant classpath. New tasks and
  types can be added to either the Ant Home or the Global Entries section(s). The Contributed Entries section cannot be
  modified.</p>
  <table class="border" style="width:80%">
    <thead>
      <tr>
        <th style="width:25%">Option</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>Add Jars...</td>
        <td>Allows you to add a <code>jar</code> file from the current workspace to the Ant classpath for the Ant Home
        and / or Global sections.</td>
      </tr>
      <tr>
        <td>Add External Jars...</td>
        <td>Allows you to add a <code>jar</code> file from the local filesystem to the Ant classpath for the Ant Home
        and / or Global sections.</td>
      </tr>
      <tr>
        <td>Add Folder...</td>
        <td>Allows you to add a folder from the local filesystem to the Ant classpath for the Ant Home and / or Global
        sections.</td>
      </tr>
      <tr>
        <td>Add Variable...</td>
        <td>Allows you to add a new classpath variable to the Ant Home and / or Global sections.</td>
      </tr>
      <tr>
        <td>Ant Home</td>
        <td>Allows you to add a new folder to the Ant Home location.</td>
      </tr>
      <tr>
        <td>Remove</td>
        <td>Allows you to remove the selected entry element(s) from the Ant classpath for the Ant Home and / or Global
        sections.</td>
      </tr>
      <tr>
        <td>Up</td>
        <td>Allows you to move the selected entry element up one space in its listing.</td>
      </tr>
      <tr>
        <td>Down</td>
        <td>Allows you to move the selected entry element down one space in its listing.</td>
      </tr>
    </tbody>
  </table>
  <h2>Tasks Options</h2>
  <p>On the Tasks tab you can add tasks defined in one of the classes on the Ant classpath.</p>
  <table class="border" style="width:80%">
    <thead>
      <tr>
        <th style="width:25%">Option</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>Add Task...</td>
        <td>Allows you to add a new Ant task definition to the runtime.</td>
      </tr>
      <tr>
        <td>Edit Task...</td>
        <td>Allows you to edit an existing Ant task.<br>
        <br>
        Note: you can only edit tasks that are not contributed (i.e. yellow decorated tasks are contributed and cannot
        be edited).</td>
      </tr>
      <tr>
        <td>Remove</td>
        <td>Allows you to remove an existing Ant task from the runtime.<br>
        <br>
        Note: you can only remove tasks that are not contributed (i.e. yellow decorated tasks are contributed and
        cannot be removed).</td>
      </tr>
    </tbody>
  </table>
  <h2>Types Options</h2>
  <p>On the Types tab you can add types defined in one of the classes on the classpath.</p>
  <table class="border" style="width:80%">
    <thead>
      <tr>
        <th style="width:25%">Option</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>Add Type...</td>
        <td>Allows you to add a new type defined in one of the classes on the Ant classpath.</td>
      </tr>
      <tr>
        <td>Edit Type...</td>
        <td>Allows you to edit an existing type.</td>
      </tr>
      <tr>
        <td>Remove</td>
        <td>Allows you to remove an existing type.</td>
      </tr>
    </tbody>
  </table>
  <h2>Properties Options</h2>
  <p>On the Properties tab you can add properties and property files that will be passed into Ant.</p>
  <table class="border" style="width:80%">
    <thead>
      <tr>
        <th style="width:25%">Option</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td>Add Property...</td>
        <td>Allows you to add a new Ant property to the runtime.</td>
      </tr>
      <tr>
        <td>Edit Property...</td>
        <td>Allows you to edit an existing Ant property.<br>
        <br>
        Note: you can only edit properties that are not contributed (i.e. yellow decorated properties are contributed
        and cannot be edited).</td>
      </tr>
      <tr>
        <td>Remove</td>
        <td>Allows you to remove an existing Ant property from the runtime.<br>
        <br>
        Note: you can only remove properties that are not contributed (i.e. yellow decorated properties are contributed
        and cannot be removed).</td>
      </tr>
      <tr>
        <td>Add Files...</td>
        <td>Allows you to add a <code>*.properties</code> file from the workspace to be used in the runtime.</td>
      </tr>
      <tr>
        <td>Add External...</td>
        <td>Allows you to add a <code>*.properties</code> file from the local filesystem to be used in the
        runtime.</td>
      </tr>
      <tr>
        <td>Remove</td>
        <td>Allows you to remove an existing <code>*.properties</code> file from the runtime.</td>
      </tr>
    </tbody>
  </table>
  <h3 class="related">Related Concepts</h3><a href="../concepts/concepts-antsupport.htm">Ant support</a>
  <h3 class="related">Related Reference</h3><a href="../reference/ref-antprefs.htm">General Ant preferences</a><br>
  <a href="../reference/ref-anteditorprefs.htm">Ant editor preferences</a><br>
  <a href="../reference/ref-antformatter.htm">Ant formatter preferences</a><br>
  <a href="../reference/ref-anttemplates.htm">Ant templates preferences</a>
</body>
</html>
